home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / CAT_DISK / PC_CAT.ZIP / PCATXLT1.DOC < prev    next >
Encoding:
Text File  |  1990-11-15  |  5.6 KB  |  107 lines
  1.             Documentation for the PC-Catalog translation program PCATXLT
  2.                        (C) Copyright 1990 by Dale R. Andrews
  3.                                 All rights reserved
  4.  
  5.                                     Version 1.0
  6.  
  7.  
  8.              PCATXLT is a program designed primarily to translate
  9.         PC-Catalog catalogs to and from other database formats.  It could
  10.         also be used to translate catalogs between other database formats
  11.         and, to a limited extent, general database information other than
  12.         catalogs.  It presently supports the following formats: PC-Catalog,
  13.         dBase III, DIF, ASCI and SDF.  Most database programs should accept
  14.         at least one of these formats.  This allows you to use PC-Catalog
  15.         for its strengths (updating, searching, and automatically adding
  16.         descriptions) and other programs where it may be weak (report
  17.         generation).
  18.  
  19.              PCATXLT is very easy to use.  It is menu driven so you start
  20.         it by simply executing PCATXLT.  You are presented with a menu
  21.         asking for the format of the catalog source.  After selecting one,
  22.         you are asked for the destination format.  Next, you are asked for
  23.         the filename of your input file.  You should have noticed by now
  24.         the similarity to PC-Catalog and that is, of course, intentional.
  25.         After correctly supplying an input file name, you are asked for the
  26.         output name.  You will be warned before overwriting an existing
  27.         file.
  28.  
  29.              Next you are asked for the maximum string length.  All except
  30.         SDF will read whatever length records are available.  The record
  31.         lengths read by SDF is defined by the user.  dBase has a maximum
  32.         written string length of 254 characters.  All others will write
  33.         lengths defined by PC-Catalog or the string length input by the
  34.         user, whichever is less.  Some programs using the DIF format may
  35.         have a maximum string length as low as 64 characters.  Several are
  36.         far below 255 and will just crash if longer strings are input.  You
  37.         will either need to find the limitation in the program reading the
  38.         DIF file or experiment with smaller and smaller string lengths
  39.         until the program accepts them.  This may also apply to ASCII and
  40.         SDF files.
  41.  
  42.         The lengths defined by PC-Catalog are:
  43.  
  44.                   11 - Volume
  45.                   67 - Subdirectory
  46.                   12 - File
  47.                   12 - Library member
  48.                    1 - Library type
  49.                    8 - Date
  50.                    8 - Time
  51.                    9 - Size
  52.                    9 - Free size (Volumes only)
  53.                  255 - Keywords
  54.                  255 - Descriptions
  55.  
  56.                     PCATXLT - PC-Catalog translation program         Page 2
  57.  
  58.              Finally, if you chose an SDF format for either the input or
  59.         the output, you will be asked to completely define the locations of
  60.         every field.  To eliminate a field entirely, just make its length
  61.         zero.  Notice that when you change the order, length, etc., that
  62.         the other fields change also.  It can get confusing however so I
  63.         would suggest that you set the order first (unused entries at the
  64.         bottom) and then the field lengths next.  If you do the starting
  65.         and ending positions last, the position calculations should usually
  66.         be correct before you enter them.  Try it.
  67.  
  68.              To put spaces between entries in SDF format, either increase
  69.         the size by the number of spaces required or change the starting
  70.         positions.  If you increase the size, spaces will be added AFTER
  71.         the entry.
  72.  
  73.              At this point, PCATXLT will go ahead and do the translation
  74.         and return you to the main menu.  You can press [ESC] at this point
  75.         to exit.  You could have also pressed [ESC] at many points along
  76.         the way to get out.
  77.  
  78.         General comments:
  79.  
  80.              DIF and ASCII both use double quotes (") as a delimiter so
  81.         double quotes in Keywords and Descriptions are converted to back
  82.         quotes (`) in these formats.
  83.  
  84.              Keywords are normally separated by a single space in dBase
  85.         format and tabs in the others.  Many programs don't know what to do
  86.         with the tabs.  I have left this to the user to handle since they
  87.         can be extremely handy to get "correct" spacing and can be easily
  88.         eliminated by a filter program in SDF and ASCII formats.
  89.  
  90.              PC-Catalog allows more than one word per 10 byte keyword field
  91.         but PCATXLT will permanently separate them to one word per field.
  92.  
  93.              If you translate to a "CAT" file, PC-Catalog will expect
  94.         everything to be presorted by Volume, Subdirectory, File, and
  95.         Library Member.  If they aren't, PC-Catalog will still be able to
  96.         read the catalog but you may get unexpected results from some of
  97.         the functions.  PCATXLT is smart enough to create the proper
  98.         records if you don't have separate volume and subdirectory records
  99.         but it won't sort them for you.  For example, you could have an SDF
  100.         file that had only file names (such as a bulletin board list) and
  101.         PCATXLT will create a correct "CAT" file (with blank volume and
  102.         subdirectory fields) as long as the SDF file is sorted by filename.
  103.         You could also translate a dBase file with only file records as
  104.         long as the entries were sorted by volume, subdirectory and file
  105.         name.
  106.  
  107.